home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / dev / gui / js_tools123.lha / js_tools / Documentation < prev    next >
Encoding:
Text File  |  1995-03-03  |  5.0 KB  |  159 lines
  1.  
  2.                       the js_tools.library 1.23
  3.  
  4.                       for amiga os 2.0 or better
  5.  
  6.                        free to copy and to use
  7.  
  8.  
  9. Overview
  10.  
  11.   The  js_tools.library  has some nice features that make live easier.
  12. In  this  current release this is a very good and fast listview gadget
  13. and some things around it.
  14.  
  15.  
  16. Features
  17.  
  18.   listview:
  19.  
  20.    - most important was the same behavior and looking like the OS3.0
  21.      original - and it does!
  22.  
  23.    for programmer:
  24.  
  25.    - to program like the gadtools listview 
  26.    - easy for programmers to realize a (own) keyboard interface
  27.      with special functions (like showing the selected line with only
  28.      1 call and minimized scrolling)
  29.    - special function for listview keyboard interface (simply give
  30.      it the key, the gadget and the IntuiMessage)
  31.    - looks like the OS3.0 listview
  32.    - mark lines (only by the program or by the user with SHIFT key
  33.      or always)
  34.    - Super Listview allows horizontal scrolling to show long lines
  35.    - easy column managment done be the library
  36.    - callback hook to manipulate the output (in style, colour,
  37.      graphic and ore)
  38.    - automatic text fit for information texts
  39.    - lvExtraWindow generates a listview in an own window that is
  40.      controlled by the library (resize, update, refresh, etc)
  41.    - special "AskTags" that allow to get information more special
  42.      than the GetAttributes way
  43.    - a GetGadgetAttrsA() of OS3.0 to get information
  44.  
  45.    - and all of the gadtools listview features 
  46.  
  47.    for users:  
  48.    
  49.    - easy multiselect with SHIFT + LEFT_MOUSE or simply with
  50.      MIDDLE_MOUSE
  51.    - faaast scroll mode if user moves the mouse above or below
  52.      listview box and moves it slowly left or right (same in
  53.      super listview)
  54.    - standard keyboard interface behavior  
  55.    - gadtools listview 3.0 looking
  56.    - clear looking listviews (with more than 1 column)
  57.    - help texts in a extra window (lvExtraWindow) because they are
  58.      easy to make by the programmer
  59.  
  60.   more:
  61.    
  62.    - QuickSort for Lists (usefull in listview)
  63.  
  64.  
  65. Licenses
  66.  
  67.   The  js_tools.library is copyright (c) 1995 by J.Schmitz. It is free
  68. to  copy  and  to use. You MUST NOT change anything in the distributed
  69. archive.   It  is  allowed  to  copy  the  (unpacked)  archive  to  PD
  70. collections (disks or CD).
  71.  
  72.   Feel  free  to use it and make nice programs with it. This is why it
  73. was  made.  If  your program need it put it into your distribution but
  74. tell  your  users  that you use it (e.g. in your doc file, info box or
  75. copy  this  documentation).  And  don't  forget  to  tell them the new
  76. features (look in features/for users list).
  77.  
  78.   It  it no replacement for other gadget systems (exept their listview
  79. of  course).  If  you  like send my some (nice) results or presents or
  80. money - or simply a mail... :-)
  81.  
  82.  
  83. Install
  84.  
  85.   Click  the "INSTALL" script. If will run the commodore Installer and
  86. make everything for you.
  87.  
  88.  
  89. Use
  90.  
  91.   To  use  the library you can find the C includes (for SAS/C) and the
  92. unit  source  for  Kick-Pascal.  Copy  the  C includes to your include
  93. directory.  The  KP  unit source has to be compiled first and you have
  94. to  copy  "lvHookCode.o"  to  your UNITs directory. Then it may simply
  95. used  by  "uses  js_tools"  putting  into  your  programs. It has some
  96. additional things - I hope you know how to use them....
  97.  
  98.   The  version  for  exec/OpenLibrary()  is 37 - like all others OS2.0
  99. libraries.  Some  features  are  currently PRIVATE. So don't use them
  100. until they are official released.
  101.  
  102.   If  you  want to see this library in action look out for BARNEY, the
  103. famous Fido filelist viewer.
  104.  
  105.  
  106. Future plans
  107.  
  108.   better lvExtraWindow
  109.   graphical readonly listview
  110.   lvExtraWindow with button gadgets like easy requesters
  111.   special help window with posibility to print the text out (?)
  112.   memory handing system to
  113.     allow memory pools in OS2.0 and 3.0 by one function
  114.     free all memory of a program by remembering all allocated memory
  115.   requester tools (filerequester, fontrequester & co would be nice
  116.     with this listview)
  117.  
  118.  
  119. The author
  120.  
  121.  
  122. good old post  
  123.                             Jürgen Schmitz
  124.                              Bergstr. 82
  125.  
  126.                             D-56859 Bullay
  127.                                Germany
  128.  
  129. E-Mail
  130.  
  131.                 FidoNet: Juergen Schmitz, 2:2454/550.3
  132.  
  133.                AmigaNet: Juergen Schmitz, 39:401/176.2
  134.  
  135.                  Internet: j.schmitz@trier.fh-rpl.de
  136.  
  137.  
  138. History:
  139.  
  140. version  revision
  141.  
  142. 1.??     (37.???  - some pre releases, e.g. as part of Barney archiv
  143.  
  144. 1.22     (37.210) - first public release
  145.  
  146. 1.23     (37.224) - lv_AfterHook, cdf_AdjustMid/cdf_AdjustRight now
  147.                     working (oops, forgotten?!),
  148.                     LV_KeyHandler() had wrong pragma in includes!
  149.                     some other bug fixes in C includes :-(
  150.                     LV_KeyHandler() didn't call LV_GetListViewAttrsA()
  151.                      so tags were not changed :-(
  152.                     
  153.                     added C Demos of listviews including sources
  154.                     added assembler includes
  155.  
  156.  
  157. The  library  revision  of  each version could be equal or higher than
  158. shown here because of some later small changes or bug fixes.
  159.